Update Account

The Update Account API notifies the subscriber with account details when the status of an account is updated by the subscriber.

The response for this callback notification from the subscriber should be 200 for a successfull delivery of notification. If the response is other than 200, it is meant as failed status of notification. Hence, the notification is sent for ‘n’ number of times till getting the response as 200. If still the response is not 200, the subscription for this event will be cancelled.

Example

Request Parameters

Parameter	Description
source Mandatory	String Source or origin of the event Constant value: "PL"
eventId Mandatory	String Identifier for the event associated with the update Sample value: "EVT1358242"
eventName Mandatory	String Name of the event Constant value: "Account.UPDATE"
groupId Mandatory	Array[String] List of group IDs associated with the event. Useful for tracing related account updates. Sample value: ["100000000002003","200570414017867","900885266513523"]
payload Mandatory	Object
id	String Unique ID of the account Sample value: "1356001"
name	String Name of the account Sample value: "General Account"
number	String Account number Sample value: "200570414017867"
createdDate	String Date and time of account creation Sample value: "2025-06-18T13:11:25.438Z"
updatedDate	String Date and time of last update Sample value: "2025-09-05T16:04:56.478Z"
balance	Number Current balance of the account Sample value: 6070
lowWatermarkValue	Number Lower watermark threshold for balance notifications Sample value: 7000
highWatermarkValue	Number Upper watermark threshold for balance notifications Sample value: 15000
customerID	String Customer ID assigned to the account Sample value: "100000000002003"
customerName	String Name of the customer associated with the account Sample value: "Bala"
accountType	String Type of account Sample value: "SAVINGS"
currency	String Currency of the account Sample value: "USD"
currencyCode	String ISO 4217 currency code Sample value: "840"
status	String Current status of the account Sample value: "ACTIVE"
program	String Product associated with the account Sample value: "DEFAULT"
accountLevel	String Service level associated with the account Sample value: "DEFAULT"
signature Mandatory	String Sign the request payload (params.payload) using private key. Sample Value: "MEQCIAbpxHpdOyBEVlmxPYv7m4Z1OvWJJYw7g7u3GE3T9nmvAiBjKHckSvb1M6O4t7FeWsn2z9Y3dMeYn3HyX/k28ek/Dw=="

Body

{
  "source": "PL",
  "eventId": "EVT1358242",
  "eventName": "Account.UPDATE",
  "groupId": [
    "100000000002003",
    "200570414017867",
    "900885266513523"
  ],
  "payload": {
    "accountLevel": "DEFAULT",
    "accountType": "SAVINGS",
    "balance": 6070,
    "createdDate": "2025-06-18T13:11:25.438Z",
    "currency": "USD",
    "currencyCode": "840",
    "customerID": "100000000002003",
    "customerName": "Bala",
    "lowWatermarkValue": 7000,
    "highWatermarkValue": 15000,
    "name": "General Account",
    "number": "200570414017867",
    "program": "DEFAULT",
    "status": "ACTIVE",
    "updatedDate": "2025-09-05T16:04:56.478Z"
  },
  "signature": "{{Signature}}"
}

Response: 200

{
  //The response for this callback notification from the subscriber should be 200 for a successfull delivery of notification. If the response is other than 200, it is meant as failed status of notification. Hence, the notification is sent for ‘n’ number of times till getting the response as 200. If still the response is not 200, the subscription for this event will be cancelled.
}